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Preface 


PREFACE 


1.0 Manual Objectives 


The SHOP FLOOR GATEWAY Sof tware Instal lation 
Quide/Release Notes manual shows how to install the SHOP FLOOR 
GATEWAY on VAX/VMS and provides additional information about 
tailoring the product for specific applications. 


2. 0 Audience 


This manual is intended for individuals, responsible for 
setting up and maintaining the VAX/VMS operating system and 
SHOP FLOOR GATEWAY software. 


3. 0 Prerequisites 


Readers of this manual should have a solid understanding 
f VAX/VMS operations and administration and VAX application 
oftware. In addition* a knowledge of the specific 
requirements of the installation site is essential. 


4.0 Structure- of This Document 


This manual is organized as follows: 

Chapter 1: Gives an overview of SHOP FLOOR GATEWAY. 

Chapter 2: Describes procedures to perform prior to 
installation. 

Chapter 3: Describes the SHOP FLOOR GATEWAY distribution 
kit* installation prerequisites/ and the actual installation 
procedure. 

Chapter 4: Contains Release Notes which you should read 
before installing SHOP FLOOR GATEWAY. This chapter includes 
information not included elsewhere in the documentation set* 
changes made late in the development cycle* software errors* 
and documentation omissions. 


Pre-Pac a 


Appendix A: Shows a sample installation procedure. 

Appendix B: Gives information needed to modify drivers 
for A1len-Bradley devices. 

Appendix C: Gives information needed to modify drivers 
for Modicon device support. 

Appendix 0: Gives information about DEC terminal device 
support. 

5. 0 Associated Documents 

Further information on various topics covered in this 
manual may be found in the following manuals: 

0 DECnet VMS System Manager 's Guide 

(order number AA-H803B-TE) 

o DECnet-M Version 3. 1 System Manager 7 3 Guide 

o RSX11-M Version 4. 1 Sustem Manager's Guide* 

Instal lation. Guide 

o RSX11-S Version 4.1 Sustem Manager's Guide * 

Installation Guide 

o BASEWAY Installation Quide/Release Notes (order 

number XX-12345-01) 

o SHOP FLOOR GATEWAY Installation Guide/Release Notes 
(order number XX-12355-01) 

o BASEWAY Sustem Proorammer's Guide 

(order number XX-12346-01) 

o BASEWAY User 7 s Manual and Utilities Guide 

(order number XX-12347-01) 

° VAX Software Installation Guide 

(order number AA—M545A—TE) 

o VAX/VMS Command Language User 7 s Guide 


(order number AA—D023B-TE) 



o VAX/VMS System Manager's Guide 
(order number AA—M547A—TE) 


6.0 Disposition of Software Performance Reports (SPRs) 


Questions# problems# and enhancements to Digital software 
should be reported on a Software Performance Report (SPR) form 
and mailed to the appropria'te Digital office. Only one 
problem should be described concisely on each SPR form. 
Please include all programs and data in machine-readable form 
and reference the SPR form number on the materials. 





CHAPTER 1 


OVERVIEW OF SHOP FLOOR GATEWAY 


The SHOP FLOOR GATEWAY sirvn as a data collector which 
interfaces a network of programmable devices with a user application. 
The GATEWAY can work together with Digital's BASEWAY product which 
provides application program communications and control functions. A 
manufacturing application built on Digital's BASEWAY can use the 
GATEWAY to read and write to programmable devices on the shop floor. 


1. i Terminology 


The following terminology is used in descriptions of the SHOP 
’.QOR GATEWAY system: 

gateway—a PDP-11 processor running the SHOP* FLOOR GATEWAY. 
There may be up to four PDP—ll/24s or PDP-ll/44s per system (running 
memory-only RSX-11S operating system)* DECnet-ilS* and SHOP FLOOR 
GATEWAY application software. 

host node—a VAX/VMS DECnet node that is physically adjacent to 
the gateway node. This node will be used to downline DECnet load the 
GATEWAY software to the PDP-11 processor. The SHOP FLOOR GATEWAY 
software must be installed on the host node for each gateway. .A VAX 
may be the host node for more than one gateway* but each gateway^ must 
have one and only one host node. There may be up to four VAX/VMS 
processors which communicate with the SHOP FLOOR GATEWAY and receive 
data from it. 

application—a group of processes running on a VAX/VMS system 
that will send and receive data to the gateway. Applications appear 
as a logical node to the gateway. A gateway can communicate with more 
than one application* and an application can communicate with more 
than one gateway. 
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Overview of SHOP FLOOR GATEWAY 

1.5 Tailoring the SHOP FLOOR GATEWAY 


At times you may wish to tailor the SHOP FLOOR GATEWAY to fit 
your needs; for example* you might want to add new devices or modify 
system images. 

NOTE: Devices must be supported by the current version of 

BASEWAY to he added. 

The SHOP FLOOR GATEWAY software to be downloaded to the PDP-11/24 
is located in the SFGSSYSTEM: directory. The system image is 

GATEWAY. SYS and is created by the command file SFG5SYSTEM:GATEWAY. COM. 
This runs the RSX utility VMR (Virtual Monitor Routine) and the RSX 
DECnet utility VNP (Virtual Network Program). VMR is responsible for 
setting up partitions* loading drivers* and installing and running 
tasks in GATEWAY. SYS. It uses commands from the file SFGVMR.CMD. VNP 
is responsible for setting up DECnet data structures and attributes in 
the SFG system image. It uses commands from the file SFGVNP. CMD. 

To change references to drivers* expand partitions* add tasks to 
GATEWAY. SYS* modify the SFGVMR. CMD file and invoke GATEWAY.COM. If it 
is necessary to alter some of the DECnet attributes* modify SFGVNP. CMD 
and invoke GATEWAY.COM. 

It is not possible to generate the RSX-ilS system itself with the 
files distributed as part of the SHOP FLOOR GATEWAY package. Nor is 
it possible to rebuild DECnet. 

It is possible* however* to do the following: 

o add or modify some programs run as part of the SHOP FLOOR 
GATEWAY s g s tern 

o add or- modify device drivers 

o modify some DECnet attributes through the VNP (Virtual 
Network Program). 


For further information* see Appendixes B* C* and D. 
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1.3 Hardware Requirements 


- VAX 11/750 or 11/780 (memory size dependent upon application) 

- PDP-11/24 (or PDP-11/44) with a minimum of 512K bytes of 
memory for RSX-11S, DECnet-llS, SHOP FLOOR GATEWAY tasks, and 
the dynamic programmable device database (more devices and 
larger messages may require more memory) 

- DMR-11 line interface to support DECnet links between the VAX 
and PDP 11/24, including the automatic boot module for the 
11/24. 

- DZ-11 asynchronous interfaces for communicating with shop 
floor devices; one (1) for 

each set of S Modicon lines 

each set of 8 A11en-Brad1ey lines 

each set of terminal lines 


i.4 Software Requirements 

DECnet-S, Version 3. 1 

- RSX-11S, Version 4. 1 

- VAX/VMS, Version 3. 5 

- BASEWAY, Version 1.0 

NOTE: When the SHOP FLOOR GATEWAY is installed on a system using 

VAX/VMS Version 4. 0 or later, VAX RSX is required as a prerequisite. 
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1.2 Network Configuration Supported 


The system may he tailored to meet your specific needs. 
Section 1. 3 and Appendixes 3, C* and D. 


« (user-written* 

« application) < 
■ ■+ 

I 3ASEWAY 
+ ■ — —— - —«> 

I 

I 

I 


PDP-ll/xx 
{ SHOP FLOOR l 
I GATEWAY 


iDZ ! !DZ : !DZ! 


vendor-spec ific 
protocol 



programmable devices/ 
bar code readers* etc. 


Figure 1. Typical Configuration 


See 
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CHAPTER 2 


PREPARING FOR INSTALLATION 


2. 1 Preliminary Steps 


DECnet must be installed and the names of the host and shop floor 
gateways that will be monitored by a single application must be 
defined as DECnet nodes before the PDP-ll/24s can be downloaded. 
There must be one node for each gateway. 

Each GATEWAY DECnet node must have specific characteristics 
defined manually before BASEWAY is installed. See the RSX DECnet 
Sustem Manaqer 's Guide for information on using the NCP utility. The 
following is an example GATEWAY definition: 


% RUN SYS*SYSTEM:NCP 
NCP> DEFINE NODE , 'NODE ,, 

ADDRESS "ADDRESS" 

SERVICE CIRCUIT "NAME" 

LOAD FILE "FILENAME" 

where "node" must be the name of the gateway (each DECnet node must 
have a unique node name)# "address" must be a unique node ID number# 
"name" is the service circuit name# and "filename" is the file to be 
loaded. 


An example node definition is given below: 

* RUN SYSSSYSTEM:NCP 
NCP> DEFINE NODE GATEOl 
ADDRESS 4 

SERVICE CIRCUIT DMC-0 

LOAD FILE SFG*SYSTEM:GATEWAY. SYS 
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Preparing for Installation 


After defining various nodes# gou can see if the 
characteri sti cs are set up . p^oper 1 g bg.running.NCP* 


d es ir ed 



Preparing for Installation 


* RUN SVS*SVSTEM:NCP 
NCP> SET NODE GATEOl ALL 
NCP> SHOW CHAR NODE GATEOl 

Node Volatile Characteristics as of 28-SEP-84 07:55:00 

Remote node * 4 (GATEOl) 

Service circuit 
Load file 

NCP> *'Z 

* 


NOTE: The node is now defined to both the permanent and volatile 

databases. 


» DMC-0 

* SFGSSYSTEJi: GATEWAY. SYS 


2. 2 Default CSR and Vector Assignments 


In order to set up the SHOP FLOOR GATEWAY properly/ the CSR 
(Control and Status Register) and vector addresses of certain devices 
must either conform with those in the standard SHOP FLOOR GATEWAY or 
he recommended software must be tailored after installation (see 
section 1.5). 


Device 




CSR 

Vector 

DMR from SHOP 

FLOOR 

GATEWAY 

to host 

160070 

310 

RS-232 

DZ11 

(first 8 

lines) 

160150 

360 
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CHAPTER 3 


INSTALLING THE SOFTWARE 


The system manager should be familiar with the installation 
process as .described herein for use in installing upgrades and 
up dates. 

Depending on the mass storage device and the system load; the 
installation of SHOP FLOOR GATEWAY may take from 10 to 30 minutes. 


3.1 Backing Up the System Disk Before Software Installation 


It is recommended that the system disk be backed up prior to 
nstallation. The procedure for doing the backup is described in the 
VAX So ftware Installation Guide . 


3.2 Contents of the Distribution Kit 


The GATEWAY installation kit is distributed on magnetic tape. 
All files required to install and tailor the SHOP FLOOR GATEWAY system 
are contained on the distribution. 

Each volume is labeled with an external serial number 
corresponding to the SHOP FLOOR GATEWAY product number and has a 
unique volume label. 

Volume Label Medium Contents 


SFG010 1600 bpi SHOP FLOOR GATEWAY 

magnetic tape installation procedures 

and software 
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In-stalling the Software 


NOTE: Be sure to check that the distribution kit you receive 

contains everything listed in the bill of materials enclosed with it. 
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Installing the Software 


3. 3 Installation Procedure 
3. 3. 1 Preliminary Requirements 

NOTE: SHOP FLOOR GATEWAY requires VAX/VMS Version 3. 5 or later. 

o approximately 5000 blocks (SFG peak usage) during 
installation; 

o approximately 4900 blocks (SFG net usage) after installation; 

o previous installation of VAX RSX (when installed on system 
with VAX/VMS Version 4.0 or later); 

o previous installation of BASEWAY (Version 1.0) .and VAX-DECnet 
(Version 3. 0). 


3. 3. 2 Instructions for Installation 


Messages are printed at your terminal during the installation 
procedure. Most are simple '’Yes" or "No" questions which require 
either a Y or N response. 

Proceed as follows at the console terminal (user input is shown 
in uppercase letters): 


3.3.2. 1 STEP 1: Log In. to the System Manager's Account - 

1. Log in under a privileged system manager's account/ as shown 
in the following example: 

cr 

Username: SYSTEM cr' 

Password: cr 


2. Now set up the proper group and user number and set the 
default directory to SYSUPD as follows: 

* SET UIC Cl,41 

* SET DEFAULT SYSSUPDATE 
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3. 3. 2. 2 STEP 2: Invoke VMSINSTAL - 

When you invoke VMSINSTAL* it checks the following: 

o Are you logged into the system manager's account? 

It is recommended that you install layered software from 
the system manager's account. However* any account with the 
necessary privileges is acceptable. 

o Do you have adequate account quotas for installing layered 
products? 

As long as the quotas listed in Section 2. 2. 1 are met* 
you can continue with the installation. 

o Is DECnet up and running? 

You should bring down DECnet before installing BASEWAY. 
Although the installation may succeed* problems can occur if 
someone tries to access any file associated with SHOP FLOOR 
GATEWAY (including the system HELP files) during the 
installation. 

o Are any users logged into the system? 

Users should be asked to log out before SHOP FLOOR 
GATEWAY is installed. Although the installation may succeed* 
problems can occur if someone tries to use SHOP FLOOR GATEWAY 
while the installation is in progress. 


If any of these conditions are noted* VMSINSTAL will give you an 
opportunity to stop the installation procedure (see below): 

To invoke VMSINSTAL* enter the following: 

% SVMSINSTAL SFGnnn ddn: 


The VMSINSTAL command procedure takes two parameters: 

1. product name—for SHOP FLOOR GATEWAY* the name always begins 
with ”SF£* and ends with a 3-digit version number. For 
example* Version 1.6 would be called SFG016. Hereinafter* 
this document will refer to the version number as Vn. n. 

2. device name—device names have the form ddn: * where dd is the 
device code and n is the unit number. For example* the first 
floppy diskette drive would be called "DYO:". 
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Installing tha Software 


NOTE: It is not necessary to usa tha console drive for 

nstalling SHOP FLOOR GATEWAY. However* if you do use it* be sure to 
replace any media you may have found in the drive when the 

installation is complete. 

VAX/VMS Software Product Installation Procedure 

It is dd-mmm-19yy at hh:mm. 

Enter a question mark (?) at any time for help. 

Are you satisfied with the backup of your system disk CYES3? Y 

If you feel that there are conditions which may adversely affect 
the installation* enter N. To continue* enter the letter Y (or press 
RETURN). Note that the VMSINSTAL procedure gives the default user 
response in brackets. 

3. 3. 2. 3 STEP 3: Insert the First Installation Kit Volume - 
Please mount the first volume of the set on ddn: . 


Insert the first volume of the distribution kit in the tape 
drive. Enter *Y" when you are ready to continue. Note that you must 
explicitly enter a "Y” or "N"* pressing RETURN is not an adequate 
response here.' 

* Are you ready? Y 


The SHOP FLOOR GATEWAY installation procedure now assumes 
control. The procedure checks to see that there is adequate d.isk 
space to build the product. If not* it issues an error message and 
terminates. Otherwise* the procedure processes the first volume of 
the backup save set. 

NOTE: If the SYSGEN parameters MOUNTMSG or DISMOUMSG at your 
site have been set to 1* you will receive a message from OPCOM each 
time a disk* tape* or floppy diskette is mounted or dismounted. These 
messages are normally disabled* but if they have been activated and 
you are installing from a console terminal* they will appear from 1 to 
30 seconds after each mount or dismount. 

•/.MOUNT-1-MOUNTED* SFGnnn mounted on dnn: 

The following products will be installed: 

SFG Vn. n 

Beginning installation of SFG Vn. n at hh:mm 
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%VMSINSTAL-1 -RESTORE* Restoring product saveset A. . . 


At this point* if you need to exit from the installation 
procedure* you must press CTRL/Y. 

NOTE: If you press CTRL/Y* the installation procedure deletes 

all files it has created up to. that point and exits. 

SFQSTART.COM* the startup procedure* is used to set up the 
environment for SHOP FLOOR GATEWAY downline loading and tailoring. 
During installation it will be placed in the CSYSMGR3 directory 
of the system root on which this installation is being performed. 
SYSTARTUP. COM* your system startup procedure* should be modified 
to invoke this procedure when the system boots. However* it will 
not be necessary to reboot the system after the installation* since 
this procedure is invoked as part of the installation. 

If you have not already set up the DECnet database for downline 
loading this SHOP FLOOR GATEWAY* please do so after this 
installation. 

%VMSINSTAL-I-MOVEFILES* Files will now be moved to their target 
directories. . . 


The Installation Verification Procedure <IVP) next runs test3 to 
check that the installation procedure was successful. 

Installation Verification Procedure (IVP) starting 



The installation verification procedure tests that the SHOP FLOOR 
GATEWAY was installed correctly by rebuilding the software system 
image.that will be downline loaded to a SHOP FLOOR GATEWAY computer. 


Several of the compatibility mode utilities used in the IVP log their} 
normal actions to SYS^GUTPUT. These messages will not be in the 
standard VMS message format. If an error occurs* the IVP will attemp| 
to detect it. 

Please ignore the following "VMR — *DIAG* and "VNP — SET” messages. 

VMR — *DIAG*-Loadable driver larger than 4K 
LOA TT:/PAR-DRVPAR ! TERMINALS 

VMR — *DIAG«—Installed tasks may no longer fit in partition 
SET /TOP-DRVPAR:-* 

VMR — *DIAG*—Instal1ed tasks may no longer fit in partition 
SET /TOPalNIPAR:-* § 

VNP — SET PROCESS AUX 
VNP — SET PROCESS ECL 
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VNP — SET PROCESS XPT 

VNP — SET LINE DMC-0-0 CSR 160070 VEC 310 PR I 5 

The installation verification of SHOP FLOOR GATEWAY vn. n was 
successful. 

Successful installation of SFG Vn. n at hh:mm 


SHOP FLOOR GATEWAY images and libraries are now successfully 
installed. 

You may now install more products# or you can end the 
installation procedure. To end the installation procedure# type EXIT 
(or press RETURN). 

Enter the products to be installed from the next distribution 
volume set. 

♦'Products CEXIT3: EXIT 

VMSINSTAL procedure done at hh:mm 


* 

If you removed any media from the console drive before beginning# 
you can replace it now. 

The SHOP FLOOR GATEWAY system is now installed and can be 
downline loaded with the NCP trigger command: 

$RUN SYS$SYSTEJ1: NCP 
NCP > TRIGGER NODE GATE01 


3. 3. 3 Error Conditions 


If the installation procedure or IVP fail for any reason# the 
following messages are displayed: 

7.VMSINSTAL-E-SFGFAIL# The installation of SFG Vn. n has failed. 
7.VMSINSTAL-E-IVPFAIL# The IVP for SFG Vn. n has failed. 


An error during the installation or IVP can be caused by one 
more of the following conditions: 


or 


insufficient disk space to complete the installation 
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o 

o 

o 

o 

o 


insufficient system virtual page count parameter 
insufficient process paging file quota 
insufficient process working set quota 
insufficient system maximum working set 
corrupt distribution 


To change a system parameter, or to increase an authorized quota 
value, you may need to contact your installation system manager. 


3. 4 Backup Procedure Aftar Installation 


After installing SHOP FLOOR GATEWAY you should back up the system 
disk and save the original for future reference. See the VAX Software 
Installation Guide for information on the proper procedure. 


3. 5 SHOP FLOOR GATEWAY Directory Structures 


Root directory 

GATEWAY parameter and global library 

Device interface modules 

Direct I/O server 

Generic I/O server 

Mailbox driver 

A1len-Bradley PLC driver and ACP 
Modicon programmable device driver 
and AGP 

Polled I/O server 
Utility source files 

RSX-11S support files 
System image and task files 


SYSSSYSROOT:CSFG! 

SYSSSYSROOT:CSFG. LIBRARY! 
SYSSSYSROOT: CSFG. SOURCE. DIM! 
SYSSSYSROOT:CSFG. SOURCE. DIRSRV! 
SYSSSYSROOT: CSFG. SOURCE. GENSRV! 
SYSSSYSROOT: CSFG. SOURCE. MAILBOX! 
SYSSSYSROOT: CSFG. MAILBOX. ALLENB1 
SYSSSYSROOT: CSFG. MAILBOX. MODICON! 

SYSSSYSROOT: CSFG. SOURCE. POLSRV! 
SYSSSYSROOT: CSFG. SOURCE. UTILITY! 

SYSSSYSROOT: CSFG. SUPPORT! 
SYSSSYSROOT:Cl,64! 
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3.6 GATEWAY Logical Names 


SFGSSYSTEM 


M SYS$SYSROOT: £0010643“ 


3.7 Complete List of Installed Files 


Fi lename 


Purpose 


SYSSSYSROOT: CSYSMGR3 

SFGSTART. COM 

SYSSSYSROQT: Cl,643 

AUX. DAT 
AUX. STB 
AUX. TSK 
BASMCR. TSK 
BUSWCH. TSK 
CETAB. MAC 
CETAB. STB 
CETAB. TSK 
CEX. STB 
CEX. TSK 
COMINI. TSK 
DIRSRV. TSK 
DLX. DAT 
DLX. STB 
DLX. TSK 
DLXTAB. STB 
DLXTAB. TSK 
DMC. DAT 
DMC. STB 
DMC. TSK 

DTR. TSK 

DTS. TSK 
ECL. DAT 
ECL. STB 
ECL. TSK 
ECLTAB. STB 
ECLTAB. TSK 
GATEVP. TSK 
GATEWAY. COM 
GATEWAY. STB 
GATEWAY. SYS 


GATEWAY startup command file 


Required f 
Required f 
Required f 
Required f 
SHOP FLOOR 
Required f 
Required 
Required 
Required 
Required 
Initializa 
SHOP FLOOR 
Required f 
Required 
Required 
Required 
Required 
Required 
Required 
Required 
Required 
Required 
Required 
Required 
Required 
Required 
Required 
SHOP FLOOR 
Command fi 
SHOP FLOOR 
SHOP FLOOR 


le for DECnet-llS 
le for DECnet-1IS 
le for DECnet-1IS 
le for RSX-11S 
GATEWAY Bus Watcher task 
le for DECnet-1IS 
DECnet-1IS- 
DECnet-1IS 
DECnet-1IS 
DECnet-1IS 
ion task for common areas 
GATEWAY Direct Service server task 
le for DECnet-llS 
DECnet-1IS 
DECnet-1IS 
DECnet-1IS 
DECnet-1IS 
DECnet-1IS 
DECnet-1IS 
DECnet-1IS 
DECnet-1IS 
DECnet-iIS 
DECnet-1IS 
DECnet-1IS 
DECnet-1IS 
DECnet-1IS 
DECnet-1IS 
GATEWAY Event Processor task 
le to create GATEWAY' system image 
GATEWAY symbol table 
GATEWAY system image 


le 

le 

le 

le 


le 
1 e 
le 
1 e 
1 e 
1 e 
le 
1 e 
1 e 
le 
le 
le 
le 
1 e 


for 

for 

for 

for 


for 

for 

for 

for 

for 

for 

for 

for 

for 

for 

for 

for 

for 

for 
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GENSRV.TSK 
KZDRV. STB 
KZDRV. TSK 
LOODEFS. COM 
MBDRV. STB 
MBDRV. TSK 
MBINIT. TSK 
MDH11S. TSK 
MIR. STB 
MIR. TSK 
MM011S. TSK 
MODACP. TSK 
MZDRV. STB 
MZDRV. TSK 
NCP. TSK 
NDA. TSK 
NET. TSK 
NETACP. STB 
NETACP. TSK 
NETINT. TSK 
NICE. TSK 
NT I NIT. STB 
NTINIT. TSK 
OVDRV. STB 
OVDRV. TSK 
PQLSRV. TSK 
RSDV1H. TSK 
RSX11S. STB 
RSX11S. TSK 
SFGVMR. CMD 
SFGVNP. CMD 
SLD. TSK 
STATUS. STB 
STATUS. TSK 
TKN. TSK 
TSKWCH. TSK 
TTDRV. STB 
TTDRV. TSK 
XPT. DAT 
XPT. STB 
XPT. TSK 


SHOP FLOOR GATEWAY Generic Server task 
A1len—Brad leg 13/NET DZ—11 device driver 
A1len-Bradley 13/NET DZ-il device driver 
Commands to set up environment for GATEWAY tailoring 
Mailbox device driver 
Mailbox device driver 

Initialization task for mailbox driver 
Initialization task for 13/NET support 
Required file for DECnet-llS 
Required file for DECnet-llS 
Initialization task for Modicon support 
Modicon Modbus ACP 
Modicon Modbus device driver 
Modicon Modbus device driver 
Required file for DECnet-llS 
Required file for DECnet-llS 
Alien-Brad leg 13/NET ACP 
Required file for DECnet-llS 
Required file for DECnet-llS 
Required file for DECnet-llS 
Required file for DECnet-llS 
Required file for DECnet-llS 
Required file for DECnet-llS 
Required file for RSX-11S 
Required file for RSX-11S 

SHOP FLOOR GATEWAY Polled Data server task 
Required file for RSX-11S 
Required file for RSX-11S 
Required file for RSX-11S 

VMR command file for generating GATEWAY system 

VNP command file for generating GATEWAY system 

Required file for RSX-11S 

SHOP FLOOR GATEWAY common area 

SHOP FLOOR GATEWAY common area 

Required file for RSX-11S 

SHOP FLOOR GATEWAY Task Watcher task 

RSX-11S Terminal Driver 

RSX-11S Terminal Driver 

Required file for DECnet-llS 

Required file for DECnet-llS 

Required file for DECnet-llS 



SYSSSYSROOT: CSFG. LIBRARY! 


DIMLIB. OLB 
DIMMAC. MLB 
MACRQLIB. MLB 
SFGLIB.OLB 


Gateway object library containing DIMs 
Macro library containing DIM parameters 
Macro library containing GATEWAY parameters 
Object library containing GATEWAY library routines 


SYS*SYSROOT: CSFG. SOURCE. DIM! 


Installing the Software 


DEWEC. MAC DIM device vector table 

XXDIM. MAC Sample DIM source file 

SYS*SYSROOT: CSFG. SOURCE. DIRSRV! 

DIRSRV. GLS DIRSRV. TSK objects 

DIRSRV. TKB Command file to rebuild DIRSRV. TSK 

SYS*SYSROOT: CSFG. SOURCE. GENSRV! 


GENSRV. OLB GENSRV. TSK objects 

GENSRV. TKB • Command file to rebuild GENSRV. TSK 

SYSSSYSROOT: CSFG. SOURCE. MAILBOX! 


MAILBOX. BLD 
MBDRV. MAC 
MBDRV. OLB 
MBDRV. TKB 
MBINIT. MAC 
MBINIT. TKB 
MBTAB. MAC 


Command file to rebuild mailbox driver 
Mailbox driver source 

Object library containing mailbox driver 

Command file to relink mailbox driver 

Mailbox driver initialiration task 

Command file to relink MBINIT. TSK 

Device driver data structures for mailbox driver 


SYSSSYSROOT: CSFG. SOURCE. FCSUPPORT. ALLENB! 


13NET. BLD 
KZDRV. BLD 
KZDRV. TKB 
KZTAB. MAC 


Command file to rebuild 
Command file to rebuild 
Command file to relink 1 
Symbol table for 13/NET 


MDH11S.BLD 

Command 

file 

to rebuil 

d 

MDH1IS. MAC 

Initial 

i zati 

on task so 

ur 

MDH11S.TKB 

Command 

file 

to relink 

i 

NET. BLD 

Command 

file 

to rebuil 

d 

NET. TKB 

Command 

file 

to relink 

i 

NETBUF. MAC 

Network 

buffer source 

fi 

NETDATA. MAC 

Networ k 

data 

source fi 

1 e 

NETMAC. MAC 

Parameter source file 


NETWORK. OLB 

Object 

library contain 

in 


13/NET 

13/NET driver 
3/NET driver 
driver 

initialization task 
c e file 

nitialirat ion task 
13/NET ACP 
3/NET ACP 
le 


g 13/NET routines 


SYSSSYSROOT: CSFG. SOURCE. PCSUPPORT. MODICONI 


ACPOOL. 

MAC 

Source 

MM011S. 

MAC 

Source 

MODACP. 

MAC 

Sourc e 

MODDEF. 

MAC 

Source 

MODDRV. 

ASM 

Comman 

MODDRV. 

BLD 

Comman 

MODDRV. 

OLB 

Object 

MODDRV. 

TKB 

Comman 

MODMAC. 

MAC 

Source 

MODML. MLB 

Macro 


file 

for 

ACP 



file 

for 

in i t 

ia 1 i 

zation 

file 

for 

ACP 



file 

for 

ACP 



file 

to 

reas 

semb 

le Modi 

file 

to 

rebu 

ild 

Mod icon 

library c 

: onta 

in in 

g Mo dic 

file 

to 

reli 

nk Modicon 

file 

for 

ACP 




library for ACP 


task 


con driver 
driver 
on driver 
driver 


3-11 



Installing the Software 


MODPRE. MAC 
MZDRV.MAC 
MZTAB. MAC 


Prefix file containing Modicon parameters 

Source file for driver 

Source file for driver database 


5YS*SYSR00T: CSFG. SOURCE. POLSRV! 


POLSRV. OLB POLSRV. TSK objects 

POLSRV. TKB Command file to rebuild PQLSRV. TSK 


SYS*SYSROOT: CSFG. SOURCE. UTILITY! 

COMINI. TKB Command file to relink COMINI. TSK 

POOL. TKB Command file to relink POOL. TSK 

UTILITY. QLB Object library containing utility routines 

SYS*SYSROOT:CSFG. SUPPORT! 


USLIB. OLB 
EXELIB. OLB 
EXEMC. MLB 
RSXMAC. SML 
RSXMC. MAC 
SYSLIB. OLB 
VMR. TSK 
VNP. TSK 


RSX-11S object library 
RSX-11S object library 
RSX-11S macro library 
RSX-11S macro library 
RSX-11S parameter source fils 
RSX—11S object library 
RSX-11S VMR task 
DECnet-1IS VNP task 
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CHAPTER 4 


RELEASE NOTES 


This chapter contains information important to the installation 
and operation of the SHOP FLOOR GATEWAY. 


4.1 Operation Without an Application 


Normally* the SHOP FLOOR GATEWAY will continue operating without 
an application running. Messages that are destined for an application 
are purged. When the application starts again* the GATEWAY will 
continue sending messages with the next poll. 




4-1 




APPENDIX A 


SAMPLE INSTALLATION PROCEDURE 


$ SET UIC Cl*41 

* SET DEFAULT SYS*UPDATE 

* eVMSINSTAL SFGOIO MSAO: 

VAX/VMS Software Product Installation Procedure 

It is 1-JUN-19S4 at 12:05. 

Enter a question mark (?) at any time for help. 

* Are you satisfied with the backup of your system disk CYES1? YES 

lease mount the first volume of the set on MSAO:. 

* Are you ready? YES 

'(MOUNT-1 -MOUNTED* SFGOIO mounted on _MSAO: 

The following products will be installed: 

SFG VI. 0 


Beginning installation of SFG VI. 0 at 12:07 
XVMSINSTAL-1-RESTORE* Restoring product saveset A. . . 

5FGSTART. COM* the startup procedure* is used to set up the environment 
for SHOP FLOOR GATEWAY downline loading and tailoring. During 
installation it will be placed in the CSYSMGR3 directory of the system 
root on which this installation is being performed. 5YSTAR7UP.COM* 
your system startup procedure* should be modified to invoke this 
procedure when the system boots. However* it will not be necessary to 
reboot the system after the installation* since this procedure is 
invoked as part of the installation. 
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Sample Installation Procedure 


If you have not already set up the OECnet database for downline loading 
this SHOP FLOOR GATEWAY# please do so after this installation. 



%VMSINSTAL-I-MOVEFILES# Files will now be moved to their target 


directories. . 


Installation Verification Procedure (IVP) starting 


The installation verification procedure tests that the SHOP FLOOR 
GATEWAY was installed correctly by rebuilding the software system 
image that will be downline loaded to a SHOP FLOOR GATEWAY computer. 

Several of the compatibility mode utilities used in the IVP log their 
normal actions to SYS*GUTPUT. These messages will not be in the 
standard VMS message format. If an error occurs# the IVP will attempt 
to detect it. 


Please ignore the following "VMR — *DIAG* and "VNP 


SET” messages. 


VMR — *DIAG*-Loadable driver larger than 4K 
LOA TT:/PAR»DRVPAR ! TERMINALS 

VMR *— *D1AG#—Installed tasks may no longer fit in partition 
SET /TQP*DRVPAR:—* 

VMR — *DIAG*—Installed tasks may no longer fit in partition 
SET /TOP-INIPAR:-* 

VNP — SET PROCESS AUX 

VNP — SET PROCESS ECL 

VNP — SET PROCESS XPT 

VNP — SET LINE DMC-0-0 CSR 160070 VEC 310 PRI 5 

The installation verification of SHOP FLOOR GATEWAY* vl. 0 was successful 
Successful installation of SFG VI. 0 at 12:32 




Enter the products to be installed from the next distribution volume set. 
* Products CEXITj: EXIT 

VMSINSTAL procedure done at 12:35 


APPENDIX B 


ALLEN-BRADLEY DEVICE SUPPORT INFORMATION 


B.1 AIIen-Brad1ey Devices Supported 

SHOP FLOOR CATEWAY currently supports Al1en-Brad1 eg PLC-2/30 and 
PLC-3 programmable devices. Up to 64 Al len-Brad 1 ey stations on each 
programmable device network are supported. 

B.2 Publications 


The following publication is useful if the user is writing a 
device Interface Module <DIM) for unsupported Allen-Bradley devices/ 
r another utility program: 

o User 's Guide to the Al1en-Brad1eu Data Hiahwau TM Network 
Communication Softuare (13/NET) . (1) Available from 

Allen-Brad1ey Corporation. 


1 Data Highway TM is a registered trademark 
Corporation. 


of Al1en-Brad1ey 
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VAX 




DECnet 


4 —-► 

! DMR-11! 

ISHOP FLOOR ! 

!GATEWAY ! 

! 9. 6K Baud 

I 

I 

STATION 10 


STATION 12 


PLC 


19. 2K Baud 


Data Highway TM 
Monitor Modem 


Communication 
Adapter Modem 


STATION 13 


PLC-3 ! 


DMA 


J1771-KC! 

! 1774—KA i 

1 1775—KA ! 

! or -KD« 

1 1 

r i 

1 1 

1 > 

! or -KE• 

{ or -KFi 


t 

t 

• 

1 


I 

1 

1 

l 


Communication 
Adapter Modem 


DATA 


HIGHWAY TM. . ! 
tup to 64 stations! 


Communication 
Adapter Modem 


# 


! 1771-KA 


! 19. 2K Baud 

!PLC-2/30 A i 
- ——— » — »+ 
STATION 11 


Figure 2. Typical A11en—Brad 1ey Configurat ion 
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A1len-Bradleu Device Support 


B. 3 Modifying A11en-Brad1ey Drivers 

The drivers provided for A1len-Bradley may need to be 
reassembled; task-built; and loaded into the system to accomplish the 
following: 

o define the number of DZ11 controllers and units supported 
o define the CSR and vectors for controllers 
o define line characteristics such as baud rate 
o set buffer sizes 

The line characteristics for the DZ11 devices are defined as 
fo1lows: 


Line Parameter Register 


i i i i i i i i i i i i i i i > i 


!< 8-11 >! ! ! <3—4> <0-2> 

! ! ! ! ! ! line number 

! ! ! ! ! character length 

! f * ! 1 stop code 

! f ! parity 

! f odd parity 

! speed select 
receiver on 


The standard line parameter configuration for the DZ11 on 
A1len-Bradley drivers is octal 17030 plus the line number. This 
translates to 8 bits; 1 stop bit; no parity; speed=9600. If the octal 
code is written in decimal; the value is 7700. 

The octal values to select the speed are given in the following 
table: 


300 

baud 

s 

2400 

1200 

baud 

s 

3400 

2400 

baud 

ss 

5000 

4800 

baud 

s 

6000 

9600 

baud 

3 

7000 
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Ailen-Bradley Device Support 


3.4 Default CSR and Vector Assignments 


Device CSR Vector 


Allen-Bradley DZ11 (first 8 lines) 160110 320 

Ailen-Bradley DZ11 (second 8 lines) 160120 330 


B. 4. 0. 1 Al1en-Brad1ey 13/NET Modification - 

Since the 13/NET package as implemented with this system is 
stored on a VAX and it is presumed that development will take place on 
a VAX# the command files which come with the 13/NET package for 
generation are not generally useful. Instead# several VMS command 
files and parameter files are available to rebuild the system. The 
files are found in the directory 
SYS4SYSR00T:CSFO. SOURCE. FCSUPPORT. ALLENB 1: 


Purpose 


Reassembles and rebuilds (TKB) 

13/NET. ' ' 

Used to define the number and 
size of buffers# the number of 
logical units or lines to be 
supported# and the number of 
application tasks or requests 
which may be accessed 
simultaneously. 

NET.TKB Units parameter in the TKB 

options must equal the number of 
lines supported. 

KZTAB. MAC Contains the line description 

options for each line supported 
in the system# CSRs# and vectors 
for each DZ11. 

The unit parameters are numbered from 0 to 7 for each DZ11. The 
vector and CSR must agree with that set by hardware installation. All 
lines on the same Dili must have the same values. ' The priority and 
time parameters (intercharacter timeout in ticks) should not need to 
be changed. 


Filename 

13NET. BLD 

NETBUF. MAC 
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The LPR parameter refers to the Line Parameter Register described 
b ove. 


3. 4. 0. 1. 1 Buffer Size Considerations - 

The size and number of buffers are determined by the type of 
programmable device access which characterizes the application and the 
number of lines to be supported by the system. 

For large transfers of data* as would occur in downline loading 
of programmable devices/ the most efficient size is the largest (up to 
a maximum of 230). Small buffers are most useful when smaller amounts 
are being transmitted in a single operation/ e. g. / polling of a single 
register every ten seconds. In general/ larger rather than smaller 
buffers are desirable/ if there is room in the task. Refer to the 
memory map KZDRV. MAP to find out how much memory is available. 


3. 4. 0.1.2 Driver Modification Procedure - 

The following steps are necessary to modify the 13/NET 

driver/ACP: 

1. Invoke SSFGSSYSTEM:LOGDEFS. COM 

2. Edit the KZTAB. MAC file. 

3. Edit the NETSUF. MAC file. 

4. Edit the NET. TKB file. 

5. Execute the 13NET. SLD procedure (vli 3NET. BLD ). This 

reassembles and rebuilds the driver/ACP. 

6. Copy the resulting KZDRV. TSK/NET. TSK/ and KZDRV. STB to the 
SFOSSYSTEM directory (the SHOP FLOOR GATEWAY download task 
direc tory ). 

7. Set the default to SFGSSYSTEM. 

8. Make modifications to SFGVMR; add another copy of the NET 
ACP for each 8 KZ lines. 

9. Run the VMR utility to set up the SHOP FLOOR GATEWAY system 
(SGATEWAY) again. 


The next time the SHOP FLOOR GATEWAY system is booted/ the new 
driver should be operational. 
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Allen-3radley Device Support 
E. 4. 1 RSX-11S System Image 


In order for the drivers to be used# they need to be loaded into 
the RSX operating system as well as the ACP. This is done through VMR 
commands in the fi1e SFOVMR. CMD. Any modification to the distributed 
Allen—Brad ley Configuration will require re—VMRing the GATEWAY and 
possible modification of SFGVMR.CMD. 

A copy of the 13/NET ACP must be installed for each group of S 
lines that the driver is built for. 

If a third (or additional) group of S lines is needed# you will 
need to increment the partition and task name (e. a. # NE7002# see 
below) 

Shown below are the current references to Al1en-3radley 13/NET 
tasks. Note that there are two (2) ACP3 for 16 lines. 


Allen-Bradleu Referencss in 5FQVMR. CMD : 
LOA KZ: 

SET/MAIN*NET000:*: 400: TASK 

rNS NE7/PAR*NETOOO/TASK=NETOOO/FIX»YES 

SET/MAIN-NETOO1:*: 400:TASK 

INS NET/PAR=NET001 /TASK=»NET001/FIX =YES 

INS MDH15S 


RUN NHD11S 


! Al1en-3rad1ey driver 

f Ports 1—S 

f Ports 9——16 
! AlIen-2rad1ey 
! initializer 
! (MGUnt command) 

! program 

! Run AlIen-Brad1ey 
! initialiser program 
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4.————————► 

25 Pin Female 25 Pin Female 

Connector Connector 



25 Pin Female 
Connector 



25 Pin Female 
Connector 


D2 

Pin 2 Transmit Data 
Pin 3 Receive Data 
Pin 7 Signal Ground 


Figure 3. 


(Tx ) 
(Rx ) 
(Gnd) 


KA 

Pin 2 Transmit Data (Rx) 

Pin 3 Receive Data (Tx) 

Pin 4 Request to Send (RTS) 

Pin 5 Clear to Send (CT3) 

Pin 6 Data Set Ready (DSR) 

Pin 7 Signal Ground (Gnd) 

Pin S Data Carrier Detect.(DCD) 
Pin 20 Data Terminal Ready (DTR) 


Cable Wiring Diagram for Computer to 
1775-KA Modem Connection 
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Digital 

KC 

Alien-Brad ley 


PDP 11/xx 

KD 

PLC, PLC2, PLC3 



KE 




KF 



1 1 t 

1 it 

1 

1 

1 

1 

1 1 l 

1 I t 

KF 

: ! d i 

t 

1 

1 It 1 

1 li 1 


i i Z i 

RS232 i 

; Data ; : ; 

KC 


Highway 




25 Pin Female 
Connector 


15 Pin Female 
Connector 


DZ 
+—■+ 



4 — 4 * 


25 Pin Female 
Connector 


KC, KD, KF, KE 

4 — 4 * 



15 Pin Female 
Connector 


DZ 


KF, KC, 


Pin 2 Transmit Data 
Pin 3 Receive Data < 
Pin 7 Signal Ground 


(Tx ) 

Pin 

Rx ) 

Pin 

(Gnd) 

Pin 


Pin 


2 Receive Data (Rx) 

3 Transmit Data (Tx) 

7 Signal Ground (Gnd) 
13 


Figure 4. Cable Wiring Diagram for Computer to 
KC, KD, KE, or KF Interface 
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APPENDIX C 


MODICON DEVICE SUPPORT INFORMATION 


C. 1 Devices Supported 


The SHOP FLOOR GATEWAY currently supports Mod icon 
programmable devices. Up to 32 Modicon devices on each 
device network are supported. 


484 and 584 
programmable 
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DECnet 

/ 


! PDP-11/24 


! DZ—11 



(up to 3 
per D2) 


J474 


M a D 8 U S TM (2) 


J474 


+— 


J474 


484 


584 


Figure 5. Typical Modicon Configuration 


2 Modbus TM is a registered trademark of Gould Incorporated/ 
Division. 


Mod icon 















Modicon Device Support Information 


0.2 Modifying Modicon Drivers 

The drivers provided for Modicon may need to be reassembled/ 
task-built/ and loaded into the system to accomplish the following: 

o define the number of DZ11 controllers and units supported 

o define the CSR and vectors for controllers 

o define line characteristics such as baud rate 

o set buffer sizes 

The line characteristics for the DZ11 devices are defined as 
foilows: 

Line Parameter Register 

t : i i i t : < i i t : i i : t : 



!< 9-11 >! i ! <3-4> <0-2> 

! .* ! ! ! ‘ line number 

! : ! ! ! character length 

! j j i stop code 

! * ! parity 

! 1 odd parity 

! speed select 

receiver on 


The standard line parameter configuration for the DZ11 on Modicon 
drivers is octal 17030 plus the line number. This translates to S 
bits.- 1 stop bit- no parley/ spet?d ss 9600. If the octal code is written 
in decimal/ the value is 7700. 

The octal values to select the speed are given in the following 
cable: 


300 

baud 

5= 

2400 

1200 

baud 

33 

3400 

2400 

baud 

=3 

5000 

4800 

baud 

35 

6000 

9600 

baud 

as 

7000 
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NOTE: In the macro source file MODPRE. MAC# the LPR that is to be ^0 
entered does not contain the baud rate. For the above example/ LPR 
should be set to 10030. The baud rate is specified by another 
parameter. When the driver is built# the baud rate code and base LPRs 
are OR-ed together. 


0.3 Default CSR and Vector Assignment? 


Device CSR Vector 


Modicon 0211 (first S lines) 160130 340 

Dili (second 8 lines) 160140 350 


3.0.1 Modicon Driver/ACP Modification - 


The parameters defining the number of lines# line 
for the Modicon driver are found 

3YS*SYSR00T: CSFG. SOURCE. PCSUPPORT. MOD I CONI MODPRE. MAC file, 
may be edited and the driver package rebuilt using the 
command file in the same directory. For example# to change 
of a line# simply change the BDXX value for the appropriate 

The following example may be helpful: 


speed s# 
in 

This 
MODDRV 


etc. 

the 
file 
. 3LD 


the speed 
line. 


S SET DEF SYS$SYSROOT:CSFG. SOURCE. PCSUPPORT. MOD ICON! 

* £SFG*SYSTEM: LOGDEFS .' DEFINE LOGICAL NAMES AND 

! SYMBOLS FOR PROGRAM DEVELOPMEN 

* EDIT MODPRE. MAC ! EDIT CSR/VECTOR/SPEED/PARITY# 


To reassemble and rebuild the Modicon driver# execute the command 
file as follows: 

* SMODDRV. BLD 


Next# copy the MODACP. TSK# MZDRV. TSK# and MZDRV. STB files to 
3FG*SYSTEM directory. Finally# use the VMR utility to install the 
images on the RSX system by invoking SFG*SYSTEM:GATEWAY.COM. 


the 
n ew 
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C. 3. 1 RSX-11S System Image 


In order for the drivers to be used* they need to be loaded into 
the RSX operating system as well as the ACP. This is done through VMR 
commands in the command file SFGVMR.CMD. Any modification to the 
distributed Modicon configuration will require re-VMRing the GATEWAY 
and possible modification of SFGVMR. CMD. 

Shown below are the current references to Modicon-related tasks 
in SFGVMR. CMD. 


Modicon References in SFGVMR. CMD : 
LOA MZ:/PAR»DRVPAR 

INS MODACP/PAR*G£N/PRI*120/FIX*YES 
INS MM011S/PAR=»INIPAR/FIX=YES 

RUN MM015S/155 


Modicon driver 
Modicon ACP 

Modicon initializer <MOUnt 
command) 

Run Modicon initializer in 
15 seconds after booting 
gateway 
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J478 J478 

modem modem 



Mod icon 584 
' 484 



25 Pin Female 
Connector 


25 Pin Male 
Connector 


OZ 


J478 

Modem 



25 Pin Female 
Connector 

DZ 

Pin 2 Transmit Data (Tx) 
Pin 3 Receive Data CRx) 


Pin 7 Signal Ground (Gnd) 


25 Pin Male 
Connector 

J478 modem 

Pin 2 Transmit Data (Tx) 

Pin 3 Receive Data (Rx) 

Pin 4 Request to Send (RTS) 
Pin 6 Data Set Ready (DSR) 
Pin 20 Data Terminal Ready 
Pin 7 Signal Ground (Gnd) 



DTR ) 


Figure 6. Cable Wiring Diagram for Computer to J478 Modem Connection 
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Mod icon 584 



25 Pin Female 
Connector 


DZ 

1 

2 

3 

4 

5 

6 
7 

20 

>-H 




25 Pin Female 
Connector 

OZ 

Pin 1 Signal Ground (Gnd) 
Pin 2 Transmit Data <Tx) 

Pin 3 Receive Data (Rx) 

Pin 4 Request to Send <RTS) 
Pin 5 Clear to Send <CTS) 
Pin 6 Data Set Ready (DSR) 
Pin 7 Signal Ground (Gnd) 
Pin 20 Data Terminal Ready 
Figure 7. Cable Wiring Diagram 


24-Pin 

Military Connector 
584 

C ! 

! 

I 

J ! 

I 
I 

K \ 

I 
1 

G ! 

M ! 

I 
t 

L ! 

! 

I 

P \ 

I 
I 

Z ! 

+—•+ 

24-Pin 

Military Connector 
584 

Pin C Cable Ground (Gnd) 

Pin J Receive Data (Rx) 

Pin K Transmit Data (Tx) 

Pin G Request to Send (RTS) 

Pin M Clear to Send (CTS) 

Pin L Data Terminal Ready (DTR 
Pin P Signal Ground (Gnd) 

(DTR) Pin Z Data Set Ready (DSR) 
for Computer to 584 Connection 
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APPENDIX D 


DEC TERMINAL DEVICE SUPPORT INFORMATION 


BASEUAY also supports DEC RT137 ruggedized terminals. These 
terminals have the functionality of VTIOO terminals and allow bar code 
input and data/transmission to be displayed. 

Most bar code devices that generate ASCII character sequences 
followed by a carriage return are supported. 


D. 1 Default CSR and Vector Assignments 


Jevi ce 


CSR 


Vector 


RS-232 DZ11 (first 8 lines) 


160150 360 
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